Informática Multimedia 1995 April

home *** CD-ROM | disk | FTP | other *** search

/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / CAT_DISK / DISKNDX.ZIP / DISKINDX.DOC < prev next >

Wrap

Text File | 1993-11-30 | 38.8 KB | 764 lines

DiskIndx v 2.x Copyright 1991-1993 by JN Goodale _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER TABLE OF CONTENTS I General Description ......................... 1 Volume Labels ....................... 1 Starting up ......................... 1 II Menus File Selection Screen ............... 2 Main Menu ........................... 3 Search/View/Edit .................... 4 Add Volume to index file ............ 5 Update/Display Set-Up ............... 6 Remove volume from index ............ 7 Print ............................... 8 III Requirements ............................ 10 IV Limitations ............................. 10 V Error Messages .......................... 11 VI Support/Registration .................... 13 VII Shareware Concept/Ombudsman information.. 13 >>> Previous Users of DISKINDX .............. App. A >>> Hard Drive/CD-Rom Indexing .............. App. B Registration Form ........................... App. C i I GENERAL Page 1 DESCRIPTION: Program to create an index of files stored on diskettes/disks. It can also be used to index CD-Rom disks and hard drives if the file count doesn't go beyond the limit of about 2700. The index can then be searched to locate the diskette (by volume label) where a specific file is stored. It can also be printed to the printer or a file. VOLUME LABELS: The key to indexing is using Volume Labels, both internal and external. You can label diskettes when you format them or add them later with the DOS "LABEL" command. Obviously, the internal label (written to the diskette) and the external label (the one you hand write on the outside) should be the same for this system to do you any good. DISKINDX will also label your diskettes "on the fly" for you if you are not in the habit of labeling when you format. It will NOT attempt to label hard drives or CD-Rom drives. STARTING UP: Create a directory where you will keep the indexes, such as: MD DISKINDX Copy DISKINDX.COM to that directory, or to a directory which is in your "PATH" command. Change to the directory where the indexes will be kept & execute: For Color For Monochrome or LCD ------------------------------ ---------------------------- DISKINDX White on Blue DISKINDX/M White on Black DISKINDX/1 Yellow on Blue DISKINDX/M1 Black on WHite DISKINDX/2 Yellow on Black >>>> PREVIOUS USERS of DISKINDX v 1.x If you have been using a version of DISKINDX prior to v 2.x, see Appendix A before continuing. >>>> HARD DRIVE/CD-ROM DRIVE INDEXING If you plan to use DISKINDX for Hard Drives or CD-Rom Drives, see Appendix B. II MENUS Page 2 File Selection Screen -------------------------------------------------------------------------- | DISKETTE INDEX 2.1 [UnRegistered] | | | | | | Select Index FIle to Activate... | | | | | | ______________________________________________________________ | | | ARCHIVE.!21 | | | | ZIPFILES.!21 | | | | MYFILE.!21. | | | | New Index | | | | ..Quit Pgm.. | | | | | | | |_____________________________________________________________| | | | | | | Point to selection with <──> then [ENTER] | | | | | | | | | | | -------------------------------------------------------------------------- You may have a maximum of 32 "Index files" (*.!21) files on any one directory to choose from. You may choose an existing file to update, Start a new file, or Quit entirely. The first time you execute DISKINDX, the only selections available will be "New Index" and "..Quit Pgm..". Select "New Index". You will then be asked to input a FileName (up to 8 characters, no extension), and taken to the SetUp Screen. Main Menu Page 3 -------------------------------------------------------------------------- | DISKETTE INDEX 2.1 [UnRegistered] | | Active File --> MYFILE.!21 | | | | [ M A I N M E N U ] | | | | Point to selection with then [ENTER] | | ________________________________ | | | Search/View/Edit | | | | Add Volume to Index File | | | | Volume List | | | | Update/Display SetUp | | | | Remove Volume From Index | | | | Print | | | | Shell to DOS | | | | Quit This Index | | | |________________________________| | | | | | | | | | | | -------------------------------------------------------------------------- The Main Menu may take you to a further input/selection screen. All selection menus are described in the following pages except the "Volume List", "Shell to DOS" and the "Quit This Index" menu items. "Volume List" will list a summary of all volumes indexed on this Index File. "Shell to DOS" will take you to DOS, with a message that includes the amount of memory that will be available to you to perform DOS functions. The "Quit This Index" selection will return you to the file selection screen to pick another file to work with, or to Quit. If changes have been made to this index, DISKINDX will sort and save the records before returning to the File Selection screen. Search/View/Edit Page 4 -------------------------------------------------------------------------- | DISKETTE INDEX 2.1 [UnRegistered] | | Active File --> MYFILE.!21 | | [ S E A R C H / V I E W / E D I T ] | | | | Point to selection with then [ENTER] | | Sort/Selection Options: | | _____________________________ | | | File Name | | | | Extension | | | | Volume | | | | Return to Main Menu | | | |_____________________________| | | | | Note: Selecting Volume will sequence by Directory also. | | | | | | | | | | | | | | | -------------------------------------------------------------------------- The "Search" screen is the the most useful selection, once you have indexed your floppy diskettes. You will be prompted to enter a "Search string" for whatever field you wish to search on (Volume, FIleName, or Extension). DISKINDX will find all matches to the first "n" characters of the search string. I.E., if you enter "S" for FileName, it will find all files beginning with "S". If you enter "TAX", it will find all files beginning with "TAX". Likewise, if you enter "B" for extension, it will find all "BAT" files, all "BAK" files, and any file whose extension begins with "B". If you enter nothing (hit [ENTER] with no input), ALL entries will be displayed. Sequence of the data will be based on the field selected for searching. If you selected "Volume", sequence will be by Volume/Directory. The entries will be displayed in a scrollable format. The Description Field may be edited by scrolling the desired item to the top of the display and hitting [ENTER]. Add Volume to Index File Page 5 -------------------------------------------------------------------------- | DISKETTE INDEX 2.1 [UnRegistered] | | Active File --> MYFILE.!21 | | [ A D D D I S K S ] | | | | | | _______ | | Place disk in drive | A | and hit [ENTER] >> [ESC] to quit << | | ------- | | | | | | | -------------------------------------------------------------------------- In this proceedure you are actually performing the indexing. If you have altered one of your diskettes (added or deleted a file or files), you should re-index it with DISKINDX. DISKINDX deletes all references to files previously indexed on this "Volume" and then adds back entries for all files currently on the "Volume". A "Volume" is interchangeable with "Diskette" (or one Hard Drive) and the Volume Label is what identifies it. When re-indexing, all descriptions of previously indexed files which remain on the diskette will remain in-tact, and you will be prompted to enter descriptions only for new files being added to the index. If the diskette has no volume label (DOS label), then: 1. If you have selected Manual labeling in the SetUp, you will be asked to enter a label. This label will also be written to the diskette. Be SURE to put an external (written by hand) label on the diskette with the same name you gave it for an internal label. 2. If you have selected Automatic labeling in the SetUp, DISKINDX will use the Volume Label Starter string, plus a sequential number, to automatically assign and write a label. Be sure to note the label name so you can write it on the paper label externally. If the diskette already has an internal label, then: 1. If you have selected Manual labeling in the SetUp, you will be shown the label name for confirmation, and given the opportunity to change it. If you change it, all references to BOTH the old label name and the NEW label name will be deleted before the label is written to the diskette. It will then be indexed again. 2. If you have selected Automatic labeling, no label prompt will be provided. You will be shown what diskette is being indexed, but not given any opportunity to change it. Update/Display SetUp (showing default settings) Page 6 -------------------------------------------------------------------------- | DISKETTE INDEX 2.1 [UnRegistered] | | Active File --> MYFILE.!21 | | [ S E T U P ] | | | | [ESC]-To Quit | | | | 1. Drives to be Indexed: | | Drive 1: > A < | | Can be same as Drive 1 ---> Drive 2: > A < | | | | 2. Options: | | Normaly Print to File or Printer (F/P): > F < | | Automatic or Manual Disk Labeling (A/M): > M < | | Printer Type (1/2/3): > 1 < | | [ 1-Epson 2-DeskJet/Laser 3-Neither ] | | | | 3. Computer Generated Label Starter String: > | | | | NOTE - This Set-Up is unique for : MYFILE.!21 | | | -------------------------------------------------------------------------- You must select the drive(s) to use for indexing first. If you have two drives of the same size, it's nice to be able to index on A: while you put a disk in B: - this makes indexing faster. If your drives are of different size, I suggest you should use "B" or "A" for both entries within one "Index File". If you want to index your Hard Drive, enter it's drive letter (C thru X). This will automatically set Drive 2 to the same as Drive 1. You can index a CD_Rom drive the same way, but it will act like a Hard Drive. In both cases, it will NOT attempt to write labels to the drive being indexed. You may Print to the PRINTER or to a FILE (named DISKINDX.PRN). If you elect to print to a FILE, a file will be generated which can be copied to your printer with: COPY DISKINDX.PRN PRN. It will simply be a text file containing data identical to the data which would be sent to a printer. Enter "P" here if you will normally print to a Printer, otherwise enter "F". This may be overridden at print time. If you do not have labels on your diskette(s), you may enter them manually or let the program assign them. If you select AUTOMATIC labeling, you will be asked for a starter string, and DISKINDX will use that, plus a sequential number, to generate labels. In either case, if the diskette is not labeled, DISKINDX will write a DOS label (internal label) to the diskette. Printer type is used to set the printer for condensed print for one option in the Print menu. Enter the appropriate number. Remove Volume from Index Page 7 -------------------------------------------------------------------------- | DISKETTE INDEX 2.1 [UnRegistered] | | Active File --> MYFILE.!21 | | [ R E M O V E V O L U M E ] | | | | | | Point to selection with <──> then [ENTER] | | ______________________________________________________________ | | | ..Finished.. | | | | ARCFILES001 | | | | ARCFILES002 | | | | KEEPITNOW | | | | ANYLABEL001 | | | | ANYLABEL001 | | | |_____________________________________________________________| | | | | | | | | [ENTER]-Remove [ESC]-Return [HOME] [END] [PageUp] [PageDown] | | | | | | | -------------------------------------------------------------------------- If you have "retired", lost, deleted, given away, or otherwise removed a diskette from your premisies and availability, the only way to get it off the index is to "ReMove" it from the index. If you have left the label intact, have it on hand, but deleted all the files, you may also do it by re-indexing it. But if it contains nothing, it is easier just to "Remove" it. Simply point to the Volume Name(s) you want to remove and hit [ENTER]. Remove all that apply, then select "Finished" ( or hit [ESC] ). This will delete all reference to the files formerly contained and indexed on this Index. Print Page 8 -------------------------------------------------------------------------- | DISKETTE INDEX 2.1 [UnRegistered] | | Active File --> MYFILE.!21 | | [ P R I N T ] | | | | Point to selection with then [ENTER] | | Sort/Selection Options: | | _____________________________ | | | File Name | | | | Extension | | | | Volume | | | | Volume List Summary | | | | Return to Main Menu | | | |_____________________________| | | | | Note: Selecting Volume will sequence by Directory also. | | | | | | | -------------------------------------------------------------------------- The Volume List Summary option will print (to a file or printer) the summary of volume names, similar to the Volume List screen display. The other options will print the selected contents of the index file in a sequence based on the selection. To print "ALL", leave selection criteria blank. After selection, you will be taken to the next menu, unless you chose Volume List Summary. The Volume List Summary is a printed output of the same data on the Volume List screen display. Print - Printer Detail Options Page 9 -------------------------------------------------------------------------- | DISKETTE INDEX 2.1 [UnRegistered] | | Active File --> MYFILE.!21 | | [ P R I N T ] | | | | Printer Detail Options | | ____________________________________________________ | | | Print one line with description, no directory | | | | Print one line with directory, no description | | | | Print two lines with all data | | | | Print one line, all data, CONDENSED | | | | RETURN to Previous Menu | | | |____________________________________________________| | | | | Output to: File | | Printer | | RETURN | | | | | | | | | -------------------------------------------------------------------------- Since there is more data than will fit on one 80-character line, you are given several options of how to print the data. If you have an Epson compatible or DeskJet compatible printer, you may print ALL data one one CONDENSED line. You must have chosen Printer Type 1 or 2 in the Set-Up options for this to be available. You are also given the opportunity to override the Print to Printer/FIle option selected in Set-Up. Whichever you have chosen as "Normal" during Set-Up will be the first item in the override list. III REQUIREMENTS: Page 10 IBM Compatible computer Monochrome or Color monitor 1 Fixed (Hard) Drive and 1 Floppy Drive Printer (optional) DOS 3.x or higher 256K memory (minimum - more is much better) IV LIMITATIONS: Limited to 32 index files on one path and 100 Volumes (diskettes) per index file. The number of entries allowed is based on how much DOS memory (up to 640K) you have. With 640K and normal overhead, you can index about 2700 files on one "Index File". The number of entries, or records on file, is the total of all file-names indexed plus one "control total" record for each diskette/disk indexed. Within one directory you can have up to 32 "Index Files", so could have within easy reach the index of 86,400 files. V ERROR MESSAGES (Alphabetical sequence) Page 11 Bad File Name entered --------------------- Cause: After selecting the "New File" option, you entered a file name with an extension. Do NOT enter an extension. Enter only the Base Name, which can be up to 8 characters. Response: Enter a proper file name and hit [ENTER]. File is full ------------ Cause: The Maximum number of entries will be exceed when the current directory of the current diskette is indexed. Response: The program will return to the Main Menu. Please note that the diskette that caused the overflow has NOT been indexed. See OVERFLOW at the end of the ERROR MESSAGE section. File won't fit in memory - - [ESC] to Quit ------------------------------------------ Cause: Created file on a bigger computer, or have more "overhead" loaded. Now can't read the whole file into the memory remaining. Response: [ESC] will Quit and do nothing. [ENTER] will take what it can and drop the rest. Label Can't be Blank -------------------- Cause: During indexing, if Manual labeling has been selected, spaces were entered for the label name. Response: You will be prompted to enter a valid label. Not a valid drive letter ------------------------ Cause: During "SETUP" you entered a drive letter for a drive which doesn't exist. Response: Change to a valid drive letter. Not enough memory to work with ------------------------------ Cause: Your computer does not have enough memory to hold a file array of even one element. The file is created in memory and there needs to be enough memory to hold the file array. Response: The program ends. Page 12 This is NOT an index input file ------------------------------- Cause: A file on your current path has the extension ".!02" and you selected it, but it was not created by DISKINDX and could blow the program if read in. This could happen if you re-name some unrelated file and give it the extension ".!02". The program expects to find "! Config" in the first field of the first record, and if that isn't found, you get this message. Response: You are taken back to the file selection screen. Choose a different file. Too many "*.!02" selections on this path ---------------------------------------- Cause: There are over 32 files with the extension "!02" on the currently selected path. This is an absolute limitation due to program structure. 32 separate index files SHOULD be sufficient. If not, then put them on a different directory. Response: Program ends. Move some of the *.!02 files to another directory. Write-protect violation ----------------------- Cause: Program is trying to write a label to a write- protected diskette. This only happens when the diskette doesn't have a label to begin with. Response: Hit [ENTER] and you will be given some options. They are: [ENTER] - Try again. But FIRST, remove the write- protect tab. [S] - Skip. Ignore this diskette. Remove it and put another one in. [ESC] - Bail out. Back to main menu. Also ignores this diskette. [SPACEBAR] - Indexes the diskette, but doesn't try to write a label. This allows you to index a diskette with permanent write-protection and no internal label. >>>> OVERFLOW If You reach the maximum number of entries that your memory will allow (while "Adding" diskettes to the index) you will get the "File is full" message mentioned above. When this happens, these are your options (after exiting the program): 1. Create another Index File - You can have up to 32 on one path 2. Clean house - Get rid of files you don't need 3. Get more memory (if you have less than 640K) Page 13 VI SUPPORT/REGISTRATION SUPPORT I will provide support for registered owners for six months. This includes free fixes for program bugs and notification of future enhancements. If you have questions, problems, or comments, I can be reached at: JN Goodale 7826 Littlejohn Court Charlotte, NC 28227 (704)-537-0329 CompuServe ID 71116,302 REGISTRATION You may become a registered owner by printing and completing the REGISTER.DOC form and sending it to me along with $15. Registration provides you with: 1] Support 2] Notification of upgrades 3] Latest version with reference to "UnRegistered" removed. 4] FREE copy of HARDINDX, another type of fixed disk indexer. VII SHAREWARE CONCEPT/OMBUDSMAN INFORMATION Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it! Association Of Shareware Professionals Ombudsmen This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve message via easyplex to ASP Ombudsman 70007,3536 PREVIOUS USERS OF DISKINDX App. A If you have used DISKINDX version 1.x to create index files, do not attempt to use them in verwion 2.x. The files have a new format and are named differently. If you register DISKINDX, you will receive a file conversion program to convert all your old "*.!01" indexes to the new format, with new names of "*.!21". All documentation for the conversion program (DSKNDXFX.COM) will be furnished as well. HARD DRIVE/CD-ROM DRIVE INDEXING App. B DISKINDX can now be used to index any valid hard drive or CD-Rom drive. During Set-Up, any drive letter above "B" will cause the program to assume a Hard Drive or CD-Rom drive are being indexed. Both are handled identically. Following are differences from indexing floppy diskettes and Hard Drives: 1. Both the "First" and "Second" drive letters will be the same. 2. No label writing will be done. If the Hard Drive (or CD-Rom disk) does not have a label, a label of "xDRIVE" will be used for reference, where the "x" will be the drive letter. CD-Rom disks typically contain many directories and several thousand files. Therefore, it is often impossible to index more than one per "Index File (*.!21 file) due to memory limitations. If you have more than one computer and wish to identify the computer on which a Hard Drive is indexed (for listings, etc.), add the folloing command to your AUTOEXEC.BAT file: SET PCNAME=xxxxxxxx Where "xxxxxxxx" is any name you want to use to identify the specific computer. This name will be in the heading of any printed output for Hard Drive indexes. RamDrives are handled just like Hard Drives. If you have a floppy diskette named "D", the program will think it is a Hard Drive and handle it as described! .............End of DISKINDX.DOC............ DISKINDX Registration Form App. C Fee: $15 [plus $2 S&H] [ Price guaranteed thru November 1994 ] __________________________________________________________________________ Registration for: Name ________________________________________________ Addr ________________________________________________ ________________________________________________ City ________________________ ST ____ Zip ____________ Mark X if ___ Outside USA | Postal Code ____________________________ ($4 S&H) | Country ____________________________ CompuServe ID ____________ (optional) Disk Size ___ 5 1/4 ___ 3 1/2 Mark preference with X Where did you acquire DISKINDX? __________________________________________ ========================================================================== Registration: $15.00 Shipping & Handling __.00 ----- Total: $___.00 __________________________________________________________________________ ADVANTAGES OF REGISTRATION: 1] - Latest version, with reference to UnRegistered removed. 2] - Free support from the author via CompuServe E-Mail, US Mail, or telephone for six months. 3] - Upgrade notices with the option to upgrade for a modest fee. 4] - FREE copy of FINDER, a File Find utility which will span multiple Hard Drives. 5] - Sample disk of other Shareware by this author. 6] - Avoid that feeling of GUILT!! __________________________________________________________________________ Enclose a check or money order for Total $ U.S. made payable to JN Goodale. Mail to: JN Goodale 7826 Little John Court Charlotte, NC 28227 This program is distributed as is. The author assumes no liability for damage from the use of this product or the consequence of the use of this product. ...... End of Registration Document ......